Skip to content

Simplify example app by removing Docker and web dashboard#172

Closed
sueszli wants to merge 9 commits intopiercefreeman:mainfrom
sueszli:slim-example
Closed

Simplify example app by removing Docker and web dashboard#172
sueszli wants to merge 9 commits intopiercefreeman:mainfrom
sueszli:slim-example

Conversation

@sueszli
Copy link
Contributor

@sueszli sueszli commented Feb 16, 2026

The example app had grown too complex with Docker orchestration, a full web dashboard UI and multi-stage builds. This made it harder for new users to understand the core Waymark functionality. By stripping it down to the essentials, the example now clearly demonstrates workflow patterns without infrastructure complexity.

Changes

  • Removed: Multi-stage Docker builds, frontend dashboard, docker-compose orchestration
  • Simplified: Makefile now runs Postgres in a container but tests run locally
  • Flattened: Moved workflows.py directly to example_app/ root
  • Testing: Direct workflow tests instead of HTTP integration tests

Impact

  • Net deletion: ~3,450 lines removed, ~160 lines added
  • Example app is now a minimal, focused demonstration of Waymark workflows
  • Faster iteration and easier to understand for newcomers

@sueszli
Copy link
Contributor Author

sueszli commented Feb 16, 2026

The behavior is the same and not impacted.

@piercefreeman
Copy link
Owner

@sueszli There's some value in the more complete example app, because it shows users how they'll actually integrate waymark with a serving pipeline. But agreed that the current scope is overkill. We can pair it down to a single workflow just to show the request/response/delegation logic within Docker.

Can you refactor what you have here into a new example-workflow folder (so we'll have example_app and example_workflows)... This example-workflows could also use a very basic README with run instructions.

piercefreeman added a commit that referenced this pull request Mar 1, 2026
This PR sits on top of #172 - and it also starts a chain of PRs that
will be pointing to each other's branch to simplify the review.

<img width="642" height="86" alt="image"
src="https://github.com/user-attachments/assets/a56694d2-37e2-4569-a744-780ab863079f"
/>

Here it says "into `main`" - this is right, when the PR says something
in the likes of "into `bump-thiserror`" - that means we're not ready to
merge it, and we need to merge previous ones first. Github has quite
poor support for chaining PRs - but this works for the most part, just
need to be careful.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants